VS_Login()           Forces a user to provide a correct password          CHG

Description:

  VS_Login() should be used to ensure the user is who he says he is.
  VS_Login() will prompt the user for his initials and password (as
  defined in SECURITY.DBF).  If the user cannot provide a proper
  password, it is your job as the programmer to abort your program, etc.

Syntax:     

  l_Success = VS_Login()

Pass:       

  Nothing

Return:     

  l_Success is a logical expression that will be set to .T. if the
  user successfully entered valid initialsand their associated password,
  otherwise it will be .F.

Notes:      

  The use of VS_Login() is mandatory if you plan to use the VS_ChkAuth()
  function.

Example:    

  IF .NOT. VS_Login()
     VS_DIE("Invalid Login Attempt.  Please call D.P. Services!")
  ENDIF
  ...

Usage:      

  VS_Login() provides you (the programmer) with a security measure for
  your application.